home *** CD-ROM | disk | FTP | other *** search
/ Gigarom 4 / Mac Giga-ROM 4.0 - 1993.toast / FILES / DEV / I-Z / Programmer's Key.cpt / Programmer’s Key Info < prev    next >
Text File  |  1988-05-27  |  5KB  |  105 lines
  1. Programmer's Key 1.1B5 of 05/09/88
  2. ----------------------------------
  3.  
  4. Revision History
  5.  
  6. ;    Created:  07/23/87  PM - 1.0D1    first cut using VBL task to call Debugger
  7. ;    Modified: 07/24/87  PM - 1.0D4    changed to use AutoInt1 instead of VBL's (yay!)
  8. ;          07/26/87  PM - 1.0D5     changed key combinations (works better with TMON)
  9. ;          07/26/87  PM - 1.0D6    added FlashMenuBar to ShutDown
  10. ;          08/04/87  PM - 1.0B1    added BufPtr -> sp for _ShutDowns in TMON; its stack
  11. ;                           too small, changed key combinations again (for ICOM)
  12. ;          12/29/87  PM - 1.1B1    removed BufPtr -> sp (see above)
  13. ;                     added support for classic keyboards, changed key
  14. ;                     sequences again, revved for ShowINIT31
  15. ;          01/31/88  PM - 1.1B2    added oldAutoInt7 for dual-debugger hack
  16. ;                     fixed option key bug on Classic keyboards
  17. ;          03/04/88  PM - 1.1B3    ADB sense code changed to use HWCfgFlags since
  18. ;                     SysEnvirons doesn't tell all about ISO, etc.
  19. ;          05/06/99  PM - 1.1B4  changed option-break to swap entire exception vector
  20. ;                     for better dual-debugging
  21. ;          05/09/88  PM - 1.1B5  changed option-break to always go to boot debugger
  22. ;          05/27/88  PM - 1.1B6  added _Debugger swapping to option-break
  23.  
  24. Tester Notes
  25. ------------
  26. *** The keyboard combinations have changed again, see the chart below ***
  27. 1.1B1 now supports the classic keyboards.  Try it and see what I mean.
  28. The 'hot' key is also configurable.  Let me know if you care.
  29.  
  30. There is also a very sick hack in this version which allows the use of
  31. 2 debuggers.  An example: if you rename Programmer's Key such that it
  32. loads before TMON, then pressing option-power will invoke MacsBug or
  33. the ROM minidebugger while all the other keyboard combos will still get
  34. you into TMON.  This feature is still under construction and has many
  35. pitfalls.  For instance, what happens when you use breakpoints with
  36. both MacsBug and TMON installed?  Save all your files and try it.
  37.  
  38. *** addendum to above ***
  39. The entire exception vector table is now switched out with  option-break.
  40. This means MacsBug & TMON can almost coexist.  Try it!
  41.  
  42. General Info
  43. ------------
  44. Programmer's Key is a small INIT that allows the use of the 'power-on' key of an
  45. Apple Desktop Bus keyboard as a substitute for the Programmer's Switch.
  46. To install Programmer's Key, simply drag it into your System Folder and reboot.
  47. You may then use the following key combinations:
  48.  
  49. ;    Trap Signal  = Power-Command-Option (applies to TMON only, else the same as Interrupt)
  50. ;    Interrupt    = Power-Command (for like real Programmer's Switch)
  51. ;    BootDebugger = Power-Option (allows use of MacsBug)
  52. ;    Reset         = Power-Command-[Control or Tab] (like real Programmer's Switch)
  53. ;    Restart         = Power-Command-Shift (uses ShutDown Manager)
  54. ;    ShutDown     = Power-Command-Shift-Option (uses ShutDown Manager)
  55.  
  56. To temporarily disable Programmer's Key at boot time, hold down the mouse button
  57. or the shift key.  To permanently disable it, drag it out of the System
  58. Folder.
  59.  
  60. Programmer's Key will work with any debugger, including the microdebugger in the
  61. 128K+ ROMs.  The use of the ROM debugger is discouraged since it does not
  62. have any builtin mechanisms to guard against potential problems such as
  63. interrupting a VBL task or interrupting itself.  However, Programmer's Key is no
  64. more dangerous than the real programmer's switch.
  65.  
  66. Note:
  67.     If you experience any weird behavior with the ROM debugger, please let
  68.     me know.  I have tested Programmer's Key with the ROM debugger and have had
  69.     intermitant problems after using _ExitToShell.  I'm not certain Programmer's Key
  70.     is causing the problem.
  71.  
  72. Programmer's Key will not Restart or ShutDown if the file system is busy, so
  73. if it doesn't seem to be responding, keep on holding the keys down.
  74.  
  75. Note:
  76.     There is a problem with the ShutDown key combo; if _ShutDown is
  77.      called while the 'power-on' key is down (thereby causing an
  78.     immediate reboot), the keyboard will not function properly.
  79.     If this happens, you need to ShutDown, wait a few seconds and
  80.     power back up.  This appears to be hardware problem.
  81.     I haved added a menubar flash as well as a short pause to the
  82.     ShutDown key combination so there is a chance to release
  83.     the power key.
  84.  
  85. The code to display the icon at boot time is called ShowINIT and is in the
  86. public domain and available from me directly.  If you'd like to use it in your
  87. INIT, please drop me a note.
  88.  
  89. Bug reports and comments are should be directed to one of the
  90. addresses below.
  91.  
  92. Programmer's Key may be freely distributed for non-commercial purposes
  93. as long this text file is also included.  A license is required for
  94. commercial distribution.
  95.  
  96. Enjoy,
  97.  
  98. Paul Mercer
  99.  
  100. Delphi:    PAULMERCER
  101. AppleLink: MERCER1
  102. MCI:       SOL
  103.  
  104. P.O. Box 160165
  105. Cupertino, CA  96016-0165